home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr28
/
doc_proc.zip
/
SAMP-DOC.ZIP
/
TCOPY.DOC
< prev
next >
Wrap
Text File
|
1992-11-16
|
11KB
|
134 lines
*************************************
* *
* T C O P Y *
* ON THE MVS/XA OPERATING SYSTEM *
* *
*************************************
John S. Ward
03/15/93
EJECT
EJECT
You can use the TCOPY procedure to copy the contents of one of
your tapes on to another tape. The output tape must already have been
initialized, and must have a valid external label. Also, any current
contents of the output tape will be written over by the contents of
the input tape.
TCOPY can be used to copy the following kinds of tapes:
IBM standard labeled to IBM standard labeled (SL to SL)
IBM standard labeled to nonlabeled (SL to NL)
nonlabeled to nonlabeled (NL to NL)
TCOPY cannot copy nonlabeled (NL) tapes to standard labeled (SL) tapes.
To execute TCOPY, include the following command in your JCL:
//stepname EXEC TCOPY,VIN=iiiiii,VOUT=oooooo,DSN='first.data.set',
// LIN=labelin,LOUT=labelout,DENOUT=density,EXPDT=nnnnn
Where
iiiiii...is the volume serial number of the input tape.
oooooo...is the volume serial number of the output tape.
'first.data.set'...is the name of the first data set on the input
tape. It must be enclosed in apostrophes. If the tape is
nonlabeled, simply make up a name consisting of the userid and
one or more qualifiers.
labelin...is the type of internal label on the input tape: LIN=SL
for IBM standard labeled tapes, or LIN=NL for nonlabeled tapes.
The default is LIN=SL.
labelout...is the type of internal label on the output tape: LOUT=SL
for IBM standard labeled tapes, or LOUT=NL for nonlabeled tapes.
The default is LOUT=SL.
density...is the number for the density of the output tape:
DENOUT=3 for 1600 bits-per-inch tape, DENOUT=4 for 6250 bpi
tapes. The default is DENOUT=4.
nnnnn... is the expiration date of the output tape. The default is
EXPDT=99000. EXPDT=98000 is required to copy onto a private tape.
If you don't know the name of the first data set on the input tape,
execute the procedure TINFO as follows:
//stepname EXEC TINFO,VSN=vvvvvv
Where vvvvvv is the volume serial number of the tape. Look at the
output from the job, and the first data set will be the first on the
list after the title TAPE DATA SET INFORMATION.
Remember to execute the VOLUP procedure before any job step
requiring a tape, or, starting 02/03/86, your job will be cancelled.
For more information on VOLUP, see SYS.MVS.UPDATE(VOLUP). In the case
of TCOPY, you will need TWO VOLUP requests, one for each tape.
EXAMPLE: You want to copy the contents of a tape with a volser of
123456 to a tape with a volser of ABCDEF, and you don't know the name
of the first data set on tape 123456. To find it out, you run a job
containing at least the following two steps:
//step1 EXEC VOLUP,VOLSER=123456,ACCESS=READ
//step2 EXEC TINFO,VSN=123456
You look down near the bottom of your job output (screen 3.8) and
find that the name of the first data set is, say, ASDFJK.MINE.DATA.
You use this information in the tape copy job, which will contain at
least the three following steps:
//step1 EXEC VOLUP,VOLSER=123456,ACCESS=READ
//step2 EXEC VOLUP,VOLSER=ABCDEF,ACCESS=WRITE
//step3 EXEC TCOPY,VIN=123456,VOUT=ABCDEF,DSN='ASDFJK.MINE.DATA'
If the external label on your output tape is ABCDEF, but the tape
itself is nonlabeled, step3 in the above example would look like this:
//step3 EXEC TCOPY,VIN=123456,VOUT=ABCDEF,DSN=ASDFJK.MINE.DATA,
// LOUT=NL
If the volup request is granted, your tape will be copied.